home *** CD-ROM | disk | FTP | other *** search
/ Hyper Stacks 1994 May / Hyper Stacks (Pacific HiTech)(1994)[Mac].iso / MacTools / FileCombine / FileCombiner_93.txt < prev   
Text File  |  1993-09-06  |  4KB  |  74 lines
  1. This stack will combine all TEXT (ASCII) files contained within the top
  2. or all levels of a folder of your choosing. There are faster file
  3. concatenators available (e.g., BBEdit) but you may find this utility
  4. useful when you simply want to combine all text files within a folder. 
  5. It is also useful if you wish to specify the order of the files by 
  6. some criterion such as creation date instead of the normal alphabetical
  7. order. You can even include an index of the combined files. A less
  8. flexible but much speedier method is described after the default
  9. method.
  10.  
  11. Before selecting "Combine Files..." from the Combine menu, you can:
  12.  
  13. **1) Adjust the primary and secondary sorting order of the files, i.e.,
  14. by international alphabetical order, creation or last modified date or
  15. time, file size, or Creator type, each in ascending or descending order
  16. (1°–Sort and 2°–Sort menus).
  17.  
  18. **2) Specify a particular, or all, Creator type(s) for files of type
  19. “TEXT” to be included in the combined file (click on displayed 4-letter
  20. code or select "Specify Input Creator…" from  File menu).
  21.  
  22. **3) Specify Creator type preference for the output “TEXT” file (click
  23. on displayed 4-letter code or select "Specify Output Creator…" from
  24. File menu).
  25.  
  26. **4) Specify whether to concatenate files as they are or let the stack
  27. “Add File Index and Delimiters” (Combine menu or check box button).
  28. The latter option will add a sorted file list to the start of the 
  29. combined file. It will also precede the text from each individual 
  30. file with a file delimiter (“$$>”), the file name, and two returns.
  31.  
  32. **5) Specify whether or not to include all files in any subfolders
  33. (Combine menu or check box button).
  34.  
  35. **6) Specify dates to include by date created or modified (click on
  36. Before/After buttons to toggle between the two and click on the date to
  37. reset or remove displayed date).
  38.  
  39. Once options are set, select “Combine Files...” from the Combine menu 
  40. (or click on arrow button) and choose a folder containing text files 
  41. to combine from the "choose" dialog (note: file names will not be 
  42. visible). Before combining, File Combiner will compute an estimate of 
  43. the combined text file size. At this point you can either specify the 
  44. output file name and destination or cancel.
  45.  
  46. The stack will remember your settings, and automatically warn you if you
  47. do not have sufficient disk space.
  48.  
  49. Choose "Speedy Combine..." from the Combine menu (or click the arrow
  50. button with the option key depressed) if you simply want to
  51. combine ALL text files in a folder of your choosing which has NO 
  52. subfolders. The ordering of the text will be restricted to the one
  53. determined by an alphabetical listing of the file names, but the
  54. output creator and "Add file delimiters" settings will be recognized.
  55. In the latter case, delimiters consist of a line of text with the
  56. respective file name preceding the text from each file combined.
  57.  
  58. Version History:
  59.  
  60. .90 11/16/92 (Created 11/14/92): Should work, but still have some frills
  61. to add.
  62.  
  63. .91 11/19/92 Changed the combination of externals used, and added button
  64. interface. New features include the ability to specify cut-off dates for
  65. creation or last modified file dates. Also can now optionally include
  66. files contained in subfolders.
  67.  
  68. .92 5/21/93 Fixed some script problems introduced with .91 that
  69. prevented specification of creator types. (Thanks to Rane Curl for
  70. finding these.)
  71.  
  72. .93 9/5/93 Added the new "speedy" file combining method. It is much 
  73. faster, albeit less flexible, than the default method because it uses 
  74. a previously overlooked freeware xcmd written in 1988 by Dave Fry.